﻿// =================================================================== 
// 数据访问层接口层(GDIT.Pattern)
//====================================================================
// 文件：IBulletinArticle.cs
// 项目名称：学院网站
// 创建时间：2012-08-08
// 负责人：ChenZhiGang
//引用DevExpress.Xpo程序集
// 程序集介绍：公告信息数据访问层接口
// ===================================================================
using GDIT.Model;
using DevExpress.Xpo;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Data;

namespace GDIT.Pattern
{
    public interface IBulletinArticle
    {

        /// <summary>
        /// 管理员展示页面
        /// </summary>
        /// <returns></returns>
        XPCollection SelectAllBulletinByAdmin();

        /// <summary>
        /// 查询可见字段为否的待审批记录
        /// </summary>
        /// <returns></returns>
        IDataReader SelectIsVisibleByXZ();

        /// <summary>
        /// 新增加一篇公告
        /// </summary>
        /// <param name="bulletin">需要增加的公告对象</param>
        /// <returns>1：新增成功  0：新增失败</returns>
        int InsertBulletinArticle(Mtb_BulletinArticle bulletin);

        /// <summary>
        /// 根据关键字查询并返回公告集合
        /// </summary>
        /// <param name="keyWord">输入的关键字</param>
        /// <returns></returns>
        XPCollection SelectBulletinByKeyWord(string keyWord);

        /// <summary>
        /// 删除一篇公告
        /// </summary>
        /// <param name="bulletin">需要删除的公告对象</param>
        /// <returns>1：删除成功  0：删除失败</returns>
        int DeleteBulletinArticle(int id);

        /// <summary>
        /// 更新一篇公告
        /// </summary>
        /// <param name="bulletin">需要更新的公告的对象</param>
        /// <returns>1：更新成功  0：更新失败</returns>
        int UpdateBulletinArticle(Mtb_BulletinArticle bulletin);

        /// <summary>
        /// 增加公告的点击率
        /// </summary>
        int AddBulletinArticleCounter(int id);

        /// <summary>
        /// 查询所有的公告列表
        /// </summary>
        /// <returns>返回所有的公告列表</returns>
        XPCollection SelectAllBulletinArticle();

        /// <summary>
        /// 查询所有非置顶，重点，是内部的公告列表
        /// </summary>
        /// <returns>返回所有的公告列表</returns>
        XPCollection SelectAllInternalBulletinArticle();

        /// <summary>
        /// 根据公告Id查询并返回公告单一记录
        /// </summary>
        /// <param name="id">需要查询的公告Id</param>
        /// <returns>返回公告单一记录</returns>
        Mtb_BulletinArticle SelectBulletinArticleById(int id);

        /// <summary>
        /// 根据部门名称查询并返回该部门的所有公告列表
        /// </summary>
        /// <param name="name">需要查询的部门名称</param>
        /// <returns>返回该部门的公告列表</returns>
        XPCollection SelectBulletinArticleByDepartment(string departmentName);

        /// <summary>
        /// 显示置顶公告
        /// </summary>
        /// <returns>返回置顶公告列表</returns>
        XPCollection SelectBulletinArticleByTop();

        /// <summary>
        /// 显示重点公告
        /// </summary>
        /// <returns>返回重点公告列表</returns>
        XPCollection SelectBulletinArticleByImportant();

        /// <summary>
        /// 显示内部置顶公告
        /// </summary>
        /// <returns>返回置顶公告列表</returns>
        XPCollection SelectInternalBulletinArticleByTop();

        /// <summary>
        /// 显示内部重点公告
        /// </summary>
        /// <returns>返回重点公告列表</returns>
        XPCollection SelectInternalBulletinArticleByImportant();

        /// <summary>
        /// 设置公告为内部显示
        /// </summary>
        /// <returns>1：更新成功  0：更新失败</returns>
        int UpdateBulletinArticleByInternal(Mtb_BulletinArticle bulletin);

        /// <summary>
        /// 设置公告为重点显示
        /// </summary>
        /// <returns>1：更新成功  0：更新失败</returns>
        int UpdateBulletinArticleByImportant(Mtb_BulletinArticle bulletin);

        /// <summary>
        /// 设置公告为置顶显示
        /// </summary>
        /// <returns>1：更新成功  0：更新失败</returns>
        int UpdateBulletinArticleByTop(Mtb_BulletinArticle bulletin);

        /// <summary>
        /// 显示首页的公告内容
        /// </summary>
        /// <returns></returns>
        XPCollection SelectBulletinArticleByTopAndImportant();

        /// <summary>
        /// 显示内部首页的公告内容
        /// </summary>
        /// <returns></returns>
        XPCollection SelectInternalBulletinArticleByTopAndImportant();
    }
}
